home *** CD-ROM | disk | FTP | other *** search
/ Amiga Plus Special 25 / AMIGAplus Sonderheft 25 (2000)(Falke)(DE)(Track 1 of 4)[!].iso / Tools / SFX-Player / AmigaAMP / AmigaAMP.readme < prev    next >
Text File  |  2000-05-08  |  17KB  |  437 lines
  1. Short:    MPEG audio player with GUI (68k/PPC)
  2. Uploader: Thomas Wenzel (wenzel@unixserv.rz.fh-hannover.de)
  3. Author:   Thomas Wenzel (wenzel@unixserv.rz.fh-hannover.de)
  4. Type:     mus/play
  5. Version:  2.2
  6.  
  7. Homepage
  8. --------
  9. http://amigaamp.amiga-software.com
  10.  
  11.  
  12. Introduction
  13. ------------
  14. AmigaAMP is a GUI based MPEG audio player using mpega.library on the 68k
  15. processor or the amp decoding engine in the PPC version.  Sound is played
  16. back using the AHI audio system.  AmigaAMP is NOT another frontend for the
  17. CLI based mpega.  Anyway, if you've got problems not related to the user
  18. interface but with AHI, AsyncIO or mpega.library, PLEASE contact the
  19. corresponding author directly.  I wouldn't be able to help you in this
  20. case.
  21.  
  22.  
  23. Requirements (not included in this archive!)
  24. --------------------------------------------
  25. AmigaOS 3.0 or higher
  26. 68030-50MHz processor or better
  27. mpega.library    (Aminet:util/libs/mpega_library.lha)
  28. asyncio.library  (Aminet:dev/c/AsyncIO.lha)
  29. AHI audio system (Aminet:mus/misc/ahiusr.lha)
  30.  
  31.  
  32. Recommended
  33. -----------
  34. PowerUP and ppc.library v46
  35. AmigaOS 3.1 (OS3.1 AND PowerUP v46 are needed for the spectrum analyzer!)
  36.  
  37. Features
  38. --------
  39.  - FREEWARE!  No beta, no nag requesters and no expiry date!
  40.  - GadTools based font sensitive user interface
  41.  - Alternatively WinAMP compatible user interface
  42.  - Fast, synchronous spectrum analyzer (almost no latency)
  43.  - Workbench application (you can drop icons on its window)
  44.  - Easily configurable
  45.  - AHI device-level access (uses default audio mode automatically)
  46.  - PPC (PowerUP) support
  47.  - ID3 tag editor (artist, title, albm, etc.)
  48.  
  49. Limitations
  50. -----------
  51.  - The PPC version doesn't support MPEG2.5 yet, I'm working on it
  52.  - Only simple level meters in the 68k version
  53.  - No realtime spectrum when using AmigaOS 3.0 -- sorry guys!
  54.  - No realtime spectrum when playing MP2 files yet
  55.  
  56. History
  57. -------
  58. v2.2  - better CyberGraphX compatibility
  59.       - editable playlist including loading and saving (from the menu)
  60.       - time/remain display
  61.       - freaky animation in the bottom right corner :)
  62.       - autoscrolling song/artist text in WinAMP mode
  63.       - skin display while loading on highcolor/truecolor screens
  64.       - random play (shuffle)
  65.       - more alphabetically sorted genres
  66.       - key sensitive genre requester
  67.       - pitch shift (+ and - keys on numeric keypad, * resets speed)
  68.       - improved PUBSCREEN and SCREENMODE capabilities
  69.       - fixed internal crossfader
  70.         Start two aamps and hold shift while dragging the volume slider
  71.       - support for 'nums_ex' and 'volbar' named skin images
  72.  
  73. v2.1  - configurable playback buffer size (should cure many problems!)
  74.       - fixed a bug that caused truecolor skins to be dithered even on
  75.         truecolor screens
  76.       - Skin pictures can have any extension you like as long as the name
  77.         is correct.
  78.       - Fixed a bug in the PPC loader for 48 kHz MPEGs
  79.       - asynchronous filerequester
  80.       - Skins can be reloaded at any time.
  81.       - auto-play after opening a file if playback was active before opening
  82.       - corrected some skin positions
  83.       - visualisation for the 68k version, too (level meters)
  84.       - MaxFreq finally works
  85.  
  86. v2.0  - so many changes it was worth bumping the version number :-)
  87.       - position of genre listview gadget fixed
  88.       - fixed bugs when playing mono or 22.05 kHz files
  89.       - digital volume control
  90.       - AREXX interface (see AREXX.readme)
  91.       - automatic detection if another AmigaAMP task is already
  92.         running
  93.       - alphabetically sorted playlist (not editable yet)
  94.       - configurable buffersize
  95.       - WinAMP lookalike GUI (see below)
  96.       - Improved fontsensitivity of old GUI
  97.       - cached taginfo -- will be written when the file is closed
  98.  
  99. v1.1  - name changed to AmigaAMP
  100.       - PPC version
  101.       - ID3 tag editor
  102.       - commandline support
  103.  
  104. v1.0  - initial release called MPEGAHI
  105.  
  106. Getting started (configuration)
  107. -------------------------------
  108. Important! You need a properly installed and configured AHI audio system
  109. to run AmigaAMP. Without a correct setup the sound may be very poor and
  110. AHI will draw too much CPU power!
  111.  
  112. First of all run the AHI setup program in your Prefs drawer. Select
  113. one of the units from 0 to 3 but not the Music unit. If you don't use
  114. unit 0 for anything already I recommend using that one.
  115.  
  116. Select one of the "fast stereo++" audiomodes that matches your audio
  117. hardware. For Prelude playback I recommend "Prelude:Fast 16 bit stereo++
  118. realtime".
  119.  
  120. Now you need to know what sampling rate most of your MPEG files
  121. have. Probably it's 44100 Hz because that's the standard CD rate. If
  122. you have a slow processor you may want to run AmigaAMP in frequency division
  123. mode to reduce CPU load. Have a look at the table below for the recommended
  124. settings.
  125.  
  126. It is important to set the frequency slider to your mostly used frequency
  127. divided by your chosen frequency divisor. For example, if you're going to
  128. playback lots of 44100 Hz MPEGs and frequency division is 1:2, set the
  129. Frequency slider to 22050 Hz.
  130.  
  131. If you don't plan to have several programs playing back audio at the
  132. same time, please leave the Channels slider at position 1. The remaining
  133. settings depend on your audio hardware.
  134.  
  135. Ok, press the "Save" button in the bottom left corner.
  136.  
  137. Now it's time to configure AmigaAMP itself. If you've chosen another
  138. AHI device than 0, you have to change the AHIUNIT tooltype of AmigaAMP
  139. first. If not, just start it by double clicking on its icon and pop up
  140. the setup window by chosing Config... from the menu.
  141.  
  142. Set the sliders and checkmarks to the recommended settings, save them using
  143. the menu and close the settings window again.
  144.  
  145. That's it! AmigaAMP is now configured. You may want to fine-tune the
  146. settings later. The overall performance depends on the speed of mpega.library
  147. AND the the speed of your soundcard's AHI driver.
  148.  
  149. Recommended settings (tested with Prelude:Fast 16 bit stereo++ realtime)
  150. ------------------------------------------------------------------------
  151.  
  152.           |     Layer 1/2        |        Layer 3
  153. Processor | Quality|FreqDiv|Mono | Quality|FreqDiv|Mono
  154. ----------+--------+-------+-----+--------+-------+-----
  155. 68040-40  |  high  |  1:2  | off | medium |  1:2  | on 
  156. 68060-50  |  high  |  1:1  | off |  high  |  1:1  | off
  157. PPC604e   |  high  |  1:1  | off |  high  |  1:1  | off
  158.  
  159. Note: In fact only the 68k version is affected by these settings.
  160.  
  161.  
  162. Advanced settings
  163. -----------------
  164. * Bufsize:
  165. Set the size of the read ahead buffer. Try playing with it until you
  166. get best results. (Normally 16 to 32K is best)
  167. Setting the buffersize to FILE means that the read ahead buffer will
  168. be as large as the current track eliminating all disk access during
  169. play. Attention! This option isn't 100% stable yet!
  170.  
  171. * TaskPri:
  172. Set the running task priority of AmigaAMP. The recommended value for
  173. uninterrupted playback is 1. God knows what happens if some 3rd party
  174. task rescheduler starts fiddling around with AmigaAMP's internal task
  175. priorities...
  176.  
  177. * Read ID3 TagInfo
  178. Try to read information about artist, title, etc. Because those are stored
  179. at the end of the file it may slow down loading a bit. If this function
  180. is switched off, TagInfo can neither be edited nor saved!
  181.  
  182. * Allow multiple instances
  183. Normally when you click on an MPEG file project icon while AmigaAMP is
  184. already playing another one, no second AmigaAMP task will be launched but
  185. the already running task will start playing the new file. This behaviour
  186. can be switched off. You have to start AmigaAMP twice manually and then
  187. save the config with "Allow multiple instances" switched on from both
  188. running tasks.
  189.  
  190. * Limit volume to 0dB
  191. The volume slider ranges from silence to +6dB volume so that you can boost
  192. more silent recordings. If you don't want to turn the volume above normal
  193. accidentally, you can switch on this option.
  194.  
  195. * ToolType: DIRECTORY
  196. Default directory to display in filerequester.
  197.  
  198. * ToolType/Keyword: SCREENMODE
  199. Tell AmigaAMP to use its own screen. The mode has to be specified in
  200. decimal or hexadecimal format. Hex values have to be preceeded by
  201. <0x> or <$>. Example: SCREENMODE=0x50021303
  202.  
  203. * ToolType/Keyword: PUBSCREEN
  204. Name of the public screen that Amiga